home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmDialogShell.z / XmDialogShell
Encoding:
Text File  |  2003-11-18  |  14.2 KB  |  265 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_D_i_a_l_o_g_S_h_e_l_l    - The DialogShell widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <Xm/DialogS.h>
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       Modal    and modeless dialogs use DialogShell as    the Shell
  16.       parent.  DialogShell widgets cannot be iconified.  Instead,
  17.       all secondary    DialogShell widgets associated with an
  18.       ApplicationShell widget are iconified    and de-iconified as a
  19.       group    with the primary widget.
  20.  
  21.       The client indirectly    manipulates DialogShell    via the
  22.       convenience interfaces during    creation, and it can directly
  23.       manipulate its BulletinBoard-derived child.  Much of the
  24.       functionality    of DialogShell assumes that its    child is a
  25.       BulletinBoard    subclass, although it can potentially stand
  26.       alone.
  27.  
  28.       Setting _X_m_N_h_e_i_g_h_t, _X_m_N_w_i_d_t_h, or _X_m_N_b_o_r_d_e_r_W_i_d_t_h for either a
  29.       DialogShell or its managed child usually sets    that resource
  30.       to the same value in both the    parent and the child.  When an
  31.       off-the-spot input method exists, the    height and width of
  32.       the shell may    be greater than    those of the managed child in
  33.       order    to accommodate the input method.  In this case setting
  34.       _X_m_N_h_e_i_g_h_t or _X_m_N_w_i_d_t_h    for the    shell does not necessarily set
  35.       that resource    to the same value in the managed child,    and
  36.       setting _X_m_N_h_e_i_g_h_t or _X_m_N_w_i_d_t_h    for the    child does not
  37.       necessarily set that resource    to the same value in the
  38.       shell.
  39.  
  40.       For the managed child    of a DialogShell, regardless of    the
  41.       value    of the shell's _X_m_N_a_l_l_o_w_S_h_e_l_l_R_e_s_i_z_e, setting _X_m_N_x or
  42.       _X_m_N_y sets the    corresponding resource of the parent but does
  43.       not change the child's position relative to the parent.
  44.       _X_t_G_e_t_V_a_l_u_e_s for the child's _X_m_N_x or _X_m_N_y yields the value of
  45.       the corresponding resource in    the parent.  The xxxx and yyyy
  46.       coordinates of the child's upper left    outside    corner
  47.       relative to the parent's upper left inside corner are    both
  48.       zero minus the value of _X_m_N_b_o_r_d_e_r_W_i_d_t_h.
  49.  
  50.       Note that the    IIIInnnntttteeeerrrr----CCCClllliiiieeeennnntttt CCCCoooommmmmmmmuuuunnnniiiiccccaaaattttiiiioooonnnn CCCCoooonnnnvvvveeeennnnttttiiiioooonnnnssss MMMMaaaannnnuuuuaaaallll
  51.       allows a window manager to change or control the border
  52.       width    of a reparented    top-level window.
  53.  
  54.     CCCCllllaaaasssssssseeeessss
  55.       DialogShell inherits behavior    and resources from _C_o_r_e,
  56.       _C_o_m_p_o_s_i_t_e, _S_h_e_l_l, _W_M_S_h_e_l_l, _V_e_n_d_o_r_S_h_e_l_l, and _T_r_a_n_s_i_e_n_t_S_h_e_l_l
  57.       classes.
  58.  
  59.       The class pointer is _x_m_D_i_a_l_o_g_S_h_e_l_l_W_i_d_g_e_t_C_l_a_s_s.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       The class name is _X_m_D_i_a_l_o_g_S_h_e_l_l.
  75.  
  76.     NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  77.       DialogShell defines no new resources but overrides the
  78.       _X_m_N_d_e_l_e_t_e_R_e_s_p_o_n_s_e resource in    the _V_e_n_d_o_r_S_h_e_l_l    class.
  79.  
  80.     IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  81.       DialogShell inherits behavior    and resources from the
  82.       following superclasses.  For a complete description of each
  83.       resource, refer to the man page for that superclass.
  84.  
  85.       The following    table defines a    set of widget resources    used
  86.       by the programmer to specify data.  The programmer can also
  87.       set the resource values for the inherited classes to set
  88.       attributes for this widget.  To reference a resource by name
  89.       or by    class in a .Xdefaults file, remove the _X_m_N or _X_m_C
  90.       prefix and use the remaining letters.     To specify one    of the
  91.       defined values for a resource    in a .Xdefaults    file, remove
  92.       the _X_m prefix    and use    the remaining letters (in either
  93.       lowercase or uppercase, but include any underscores between
  94.       words).  The codes in    the access column indicate if the
  95.       given    resource can be    set at creation    time (C), set by using
  96.       _X_t_S_e_t_V_a_l_u_e_s (S), retrieved by    using _X_t_G_e_t_V_a_l_u_e_s (G), or is
  97.       not applicable (N/A).
  98.  
  99.             TTTTrrrraaaannnnssssiiiieeeennnnttttSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  100.        NNNNaaaammmmeeee         CCCCllllaaaassssssss           TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  101.        _____________________________________________________________
  102.        XmNtransientFor     XmCTransientFor   Widget   NULL      CSG
  103.  
  104.  
  105.                    VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  106.      NNNNaaaammmmeeee              CCCCllllaaaassssssss               TTTTyyyyppppeeee           DDDDeeeeffffaaaauuuulllltttt        AAAAcccccccceeeessssssss
  107.      _____________________________________________________________________________________
  108.      XmNaudibleWarning          XmCAudibleWarning           unsigned    char   XmBELL        CSG
  109.      XmNbuttonFontList          XmCButtonFontList           XmFontList      dynamic        CSG
  110.      XmNdefaultFontList          XmCDefaultFontList       XmFontList      dynamic        CG
  111.      XmNdeleteResponse          XmCDeleteResponse           unsigned    char   XmUNMAP        CSG
  112.      XmNinputMethod          XmCInputMethod           String           NULL        CSG
  113.      XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned    char   XmEXPLICIT   CSG
  114.      XmNlabelFontList          XmCLabelFontList           XmFontList      dynamic        CSG
  115.      XmNmwmDecorations          XmCMwmDecorations           int           -1        CSG
  116.      XmNmwmFunctions          XmCMwmFunctions           int           -1        CSG
  117.      XmNmwmInputMode          XmCMwmInputMode           int           -1        CSG
  118.      XmNmwmMenu              XmCMwmMenu           String           NULL        CSG
  119.      XmNpreeditType          XmCPreeditType           String           dynamic        CSG
  120.      XmNshellUnitType          XmCShellUnitType           unsigned    char   XmPIXELS        CSG
  121.      XmNtextFontList          XmCTextFontList           XmFontList      dynamic        CSG
  122.      XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean           False        CSG
  123.  
  124.  
  125.                   WWWWMMMMSSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))
  137.  
  138.  
  139.  
  140.      NNNNaaaammmmeeee        CCCCllllaaaassssssss           TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  141.      ______________________________________________________________________________
  142.      XmNbaseHeight    XmCBaseHeight       int         XtUnspecifiedShellInt   CSG
  143.      XmNbaseWidth    XmCBaseWidth       int         XtUnspecifiedShellInt   CSG
  144.      XmNheightInc    XmCHeightInc       int         XtUnspecifiedShellInt   CSG
  145.      XmNiconMask    XmCIconMask       Pixmap    NULL             CSG
  146.      XmNiconPixmap    XmCIconPixmap       Pixmap    NULL             CSG
  147.      XmNiconWindow    XmCIconWindow       Window    NULL             CSG
  148.      XmNiconX        XmCIconX       int         -1                 CSG
  149.      XmNiconY        XmCIconY       int         -1                 CSG
  150.      XmNinitialState    XmCInitialState       int         NormalState         CSG
  151.      XmNinput        XmCInput       Boolean   True             CSG
  152.      XmNmaxAspectX    XmCMaxAspectX       int         XtUnspecifiedShellInt   CSG
  153.      XmNmaxAspectY    XmCMaxAspectY       int         XtUnspecifiedShellInt   CSG
  154.      XmNmaxHeight    XmCMaxHeight       int         XtUnspecifiedShellInt   CSG
  155.      XmNmaxWidth    XmCMaxWidth       int         XtUnspecifiedShellInt   CSG
  156.      XmNminAspectX    XmCMinAspectX       int         XtUnspecifiedShellInt   CSG
  157.      XmNminAspectY    XmCMinAspectY       int         XtUnspecifiedShellInt   CSG
  158.      XmNminHeight    XmCMinHeight       int         XtUnspecifiedShellInt   CSG
  159.      XmNminWidth    XmCMinWidth       int         XtUnspecifiedShellInt   CSG
  160.      XmNtitle        XmCTitle       String    dynamic             CSG
  161.      XmNtitleEncoding    XmCTitleEncoding   Atom         dynamic             CSG
  162.      XmNtransient    XmCTransient       Boolean   True             CSG
  163.      XmNwaitForWm    XmCWaitForWm       Boolean   True             CSG
  164.      XmNwidthInc    XmCWidthInc       int         XtUnspecifiedShellInt   CSG
  165.      XmNwindowGroup    XmCWindowGroup       Window    dynamic             CSG
  166.      XmNwinGravity    XmCWinGravity       int         dynamic             CSG
  167.      XmNwmTimeout    XmCWmTimeout       int         5000 ms             CSG
  168.  
  169.  
  170.                           SSSShhhheeeellllllll RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  171.      NNNNaaaammmmeeee               CCCCllllaaaassssssss             TTTTyyyyppppeeee              DDDDeeeeffffaaaauuuulllltttt       AAAAcccccccceeeessssssss
  172.      ____________________________________________________________________________________________________
  173.      XmNallowShellResize       XmCAllowShellResize     Boolean          False           CG
  174.      XmNcreatePopupChildProc   XmCCreatePopupChildProc     XtCreatePopupChildProc      NULL           CSG
  175.      XmNgeometry           XmCGeometry         String              NULL           CSG
  176.      XmNoverrideRedirect       XmCOverrideRedirect     Boolean          False           CSG
  177.      XmNpopdownCallback           XmCCallback         XtCallbackList          NULL           C
  178.      XmNpopupCallback           XmCCallback         XtCallbackList          NULL           C
  179.      XmNsaveUnder           XmCSaveUnder         Boolean          True           CSG
  180.      XmNvisual               XmCVisual         Visual    *          CopyFromParent   CSG
  181.  
  182.  
  183.                  CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee    SSSSeeeetttt
  184.      NNNNaaaammmmeeee         CCCCllllaaaassssssss             TTTTyyyyppppeeee       DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  185.      ______________________________________________________________________
  186.      XmNchildren     XmCReadOnly         WidgetList       NULL         G
  187.      XmNinsertPosition     XmCInsertPosition   XtOrderProc   NULL         CSG
  188.      XmNnumChildren     XmCReadOnly         Cardinal       0         G
  189.  
  190.  
  191.                            CCCCoooorrrreeee    RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmDDDDiiiiaaaallllooooggggSSSShhhheeeellllllll((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      NNNNaaaammmmeeee                 CCCCllllaaaassssssss                 TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt             AAAAcccccccceeeessssssss
  207.      ______________________________________________________________________________________________________________
  208.      XmNaccelerators             XmCAccelerators             XtAccelerators   dynamic             CSG
  209.      XmNancestorSensitive         XmCSensitive             Boolean          dynamic             G
  210.      XmNbackground             XmCBackground             Pixel          dynamic             CSG
  211.      XmNbackgroundPixmap         XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  212.      XmNborderColor             XmCBorderColor             Pixel          XtDefaultForeground    CSG
  213.      XmNborderPixmap             XmCPixmap                 Pixmap          XmUNSPECIFIED_PIXMAP   CSG
  214.      XmNborderWidth             XmCBorderWidth             Dimension          1                 CSG
  215.      XmNcolormap             XmCColormap             Colormap          dynamic             CG
  216.      XmNdepth                 XmCDepth                 int          dynamic             CG
  217.      XmNdestroyCallback             XmCCallback             XtCallbackList   NULL             C
  218.      XmNheight                 XmCHeight                 Dimension          dynamic             CSG
  219.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True             C
  220.      XmNmappedWhenManaged         XmCMappedWhenManaged         Boolean          True             CSG
  221.      XmNscreen                 XmCScreen                 Screen *          dynamic             CG
  222.      XmNsensitive             XmCSensitive             Boolean          True             CSG
  223.      XmNtranslations             XmCTranslations             XtTranslations   dynamic             CSG
  224.      XmNwidth                 XmCWidth                 Dimension          dynamic             CSG
  225.      XmNx                 XmCPosition             Position          0                 CSG
  226.      XmNy                 XmCPosition             Position          0                 CSG
  227.  
  228.  
  229.     TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  230.       There    are no translations for    XmDialogShell.
  231.  
  232.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  233.       _C_o_m_p_o_s_i_t_e(_3_X), _C_o_r_e(_3_X), _S_h_e_l_l(_3_X), _T_r_a_n_s_i_e_n_t_S_h_e_l_l(_3_X),
  234.       _W_M_S_h_e_l_l(_3_X), _V_e_n_d_o_r_S_h_e_l_l(_3_X),    and _X_m_C_r_e_a_t_e_D_i_a_l_o_g_S_h_e_l_l(_3_X).
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 11/11/03)
  262.  
  263.  
  264.  
  265.